home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / trmm.z / trmm
Encoding:
Text File  |  2002-10-03  |  6.2 KB  |  160 lines
  1. TRMM(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSTTRRMMMM, DDTTRRMMMM, CCTTRRMMMM, ZZTTRRMMMM - Multiplies a real or complex general
  6.      matrix by a real or complex triangular matrix
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSTTRRMMMM ((_s_i_d_e,, _u_p_l_o,, _t_r_a_n_s_a,, _d_i_a_g,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDTTRRMMMM ((_s_i_d_e,, _u_p_l_o,, _t_r_a_n_s_a,, _d_i_a_g,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b))
  16.  
  17.      Complex
  18.  
  19.         CCAALLLL CCTTRRMMMM ((_s_i_d_e,, _u_p_l_o,, _t_r_a_n_s_a,, _d_i_a_g,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b))
  20.  
  21.      Double complex
  22.  
  23.         CCAALLLL ZZTTRRMMMM ((_s_i_d_e,, _u_p_l_o,, _t_r_a_n_s_a,, _d_i_a_g,, _m,, _n,, _a_l_p_h_a,, _a,, _l_d_a,, _b,, _l_d_b))
  24.  
  25. IIMMPPLLEEMMEENNTTAATTIIOONN
  26.      IRIX systems
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      SSTTRRMMMM and DDTTRRMMMM multiply a real general matrix by a real triangular
  30.      matrix.
  31.  
  32.      CCTTRRMMMM and ZZTTRRMMMM multiply a complex general matrix by a complex
  33.      triangular matrix.
  34.  
  35.      These routines perform one of the matrix-matrix operations:
  36.  
  37.           B <- alpha op(A)B
  38.  
  39.           or
  40.  
  41.           B <- alpha B op(A)
  42.  
  43.      where _a_l_p_h_a is a scalar; _B is an _m-by-_n matrix; _A is either a unit or
  44.      nonunit upper or lower triangular matrix, and _o_p(_A) is one of the
  45.      following:
  46.  
  47.      * _o_p(_A) = _A
  48.                 _T
  49.      * _o_p(_A) = _A
  50.                 _H
  51.      * _o_p(_A) = _A     (CCTTRRMMMM and ZZTTRRMMMM only)
  52.  
  53.      where
  54.         _T
  55.      * _A  is the transpose of _A
  56.         _H
  57.      * _A  is the conjugate transpose of _A.
  58.  
  59.      These routines have the following arguments:
  60.  
  61.      _s_i_d_e      Character*1.  (input)
  62.                Specifies whether _o_p(_A) multiplies _B from the left or right,
  63.                as follows:
  64.  
  65.                _s_i_d_e = 'L' or 'l':  B <- alpha op(A)B
  66.  
  67.                _s_i_d_e = 'R' or 'r':  B <- alpha B op(A)
  68.  
  69.      _u_p_l_o      Character*1.  (input)
  70.                Specifies whether matrix _A is an upper or lower triangular
  71.                matrix, as follows:
  72.  
  73.                _u_p_l_o = 'U' or 'u':  _A is an upper triangular matrix.
  74.                _u_p_l_o = 'L' or 'l':  _A is a lower triangular matrix.
  75.  
  76.      _t_r_a_n_s_a    Character*1.  (input)
  77.                Specifies the form of _o_p(_A) to be used in the matrix
  78.                multiplication, as follows:
  79.  
  80.                _t_r_a_n_s_a = 'N' or 'n': _o_p(_A) = _A
  81.  
  82.                                              _T
  83.                _t_r_a_n_s_a = 'T' or 't', _o_p(_A) = _A
  84.  
  85.                                               _T
  86.                _t_r_a_n_s_a = 'C' or 'c':  _o_p(_A) = _A  (SSTTRRMMMM, DDTTRRMMMM),
  87.                            _H
  88.                or _o_p(_A) = _A  (CCTTRRMMMM, ZZTTRRMMMM)
  89.  
  90.      _d_i_a_g      Character*1.  (input)
  91.                Specifies whether _A is unit triangular, as follows:
  92.  
  93.                _d_i_a_g = 'U' or 'u': _A is assumed to be unit triangular.
  94.                _d_i_a_g = 'N' or 'n': _A is not assumed to be unit triangular.
  95.  
  96.      _m         Integer.  (input)
  97.                Specifies the number of rows in _B.  _m must be >= 0.
  98.  
  99.      _n         Integer.  (input)
  100.                Specifies the number of columns in _B.  _n must be >= 0.
  101.  
  102.      _a_l_p_h_a     Scalar factor.  (input)
  103.                SSTTRRMMMM: Real.
  104.                DDTTRRMMMM: Double precision.
  105.                CCTTRRMMMM: Complex.
  106.                ZZTTRRMMMM: Double complex.
  107.                When _a_l_p_h_a is 0, _a is not referenced and _b need not be set
  108.                before entry.
  109.  
  110.      _a         Array of dimension (_l_d_a,_k).  (input)
  111.                SSTTRRMMMM: Real array.
  112.                DDTTRRMMMM: Double precision array.
  113.                CCTTRRMMMM: Complex array.
  114.                ZZTTRRMMMM: Double complex array.
  115.  
  116.                When _s_i_d_e = 'L' or 'l', _k is _m; when _s_i_d_e = 'R' or 'r', _k is
  117.                _n.  Contains the matrix _A.
  118.  
  119.                Before entry with _u_p_l_o = 'U' or 'u', the leading _k-by-_k
  120.                upper triangular part of array _a must contain the upper
  121.                triangular matrix.  The strictly lower triangular part of _a
  122.                is not referenced.
  123.  
  124.                Before entry with _u_p_l_o = 'L' or 'l', the leading _k-by-_k
  125.                lower triangular part of array _a must contain the lower
  126.                triangular matrix.  The strictly upper triangular part of _a
  127.                is not referenced.
  128.  
  129.                When _d_i_a_g = 'U' or 'u', the diagonal elements of _a are not
  130.                referenced, but they are assumed to be unity.
  131.  
  132.      _l_d_a       Integer.  (input)
  133.  
  134.                Specifies the first dimension of _a as declared in the
  135.                calling program.
  136.                When _s_i_d_e = 'L' or 'l', _l_d_a >= MMAAXX(1,_m).  When _s_i_d_e = 'R' or
  137.                'r', _l_d_a >= MMAAXX(1,_n).
  138.  
  139.      _b         Array of dimension (_l_d_b,_n).  (input and output)
  140.                SSTTRRMMMM: Real array.
  141.                DDTTRRMMMM: Double precision array.
  142.                CCTTRRMMMM: Complex array.
  143.                ZZTTRRMMMM: Double complex array.
  144.                Contains the matrix _B.
  145.  
  146.                Before entry, the leading _m-by-_n part of array _b must
  147.                contain matrix _B.  On exit, the transformed matrix
  148.                overwrites array _b.
  149.  
  150.      _l_d_b       Integer.  (input)
  151.                Specifies the first dimension of _b as declared in the
  152.                calling program.  _l_d_b >= MMAAXX(1,_m).
  153.  
  154. NNOOTTEESS
  155.      These routines are Level 3 Basic Linear Algebra Subprograms (Level 3
  156.      BLAS).
  157.  
  158. SSEEEE AALLSSOO
  159.      This man page is available only online.
  160.